home *** CD-ROM | disk | FTP | other *** search
/ Dr. Windows 3 / dr win3.zip / dr win3 / VISUALBA / PBTL111.ZIP / PBTLIB.DOC < prev    next >
Text File  |  1994-04-14  |  7KB  |  189 lines
  1.                                PBTLIB 1.11
  2.                      PBTools Librarian for PowerBASIC
  3.  
  4. One of the best new features of PowerBASIC 3.0 was it's ability to store
  5. and use objects and units in libraries for easier management.  To that
  6. end, PowerBASIC came with PBLIB PowerBASIC, Inc's version of a library
  7. management utility.
  8.  
  9. While it adequately does it's job.  It is a far cry from a conventional
  10. LIB utility such as those made by MicroSoft and Borland.  It's ability
  11. to take multiple command line options and generate a text file listing
  12. of libraries was noticeably absent.  Not to mention it's unorthodox way
  13. of handling multiple command response files.
  14.  
  15. Along comes my most ambitious project, PBTools:Professional.  A large
  16. professional library of procedures and tools.   With over 400 procedures
  17. in it, I needed a better way to manage and build libraries.  Preferably
  18. something that would work well with a MAKE utility.
  19.  
  20. Thus PBTLIB was born.  It allows you to create and manage PowerBASIC
  21. library files and modules.  You can add, remove, extract, and update
  22. modules, either interactively or in batch.
  23.  
  24.  
  25. USING PBTLIB:
  26.  
  27.   PBTLIB library[.PBL] [options] [@][commands] [,listfile]
  28.  
  29.   Options:
  30.      /?             : display PBTLIB options
  31.      /DIR           : display modules in current directory
  32.      /INFO          : about PBTLIB
  33.      /LIB           : display modules in current library
  34.      /NOLOGO        : do not display sign-on logo
  35.   Commands:
  36.      +module        : add module to library
  37.      -module        : remove module from library
  38.     -+module        : replace module in library
  39.      *module        : extract module from library
  40.     -*module        : extract and remove module from library
  41.  
  42.  
  43.   /?
  44.  
  45.     The /? option is available from the command line, at any prompt
  46.     during interactive mode and displays a list of available options.
  47.  
  48.   /DIR
  49.  
  50.     The /DIR option only works in interactive mode.  When typed at the
  51.     "Library name[.PBL]" command line, it provides you a list of all
  52.     libraries in the current directory.  When typed at the "Operation:"
  53.     command line, it provides you a list of objects and units in the
  54.     current directory.
  55.  
  56.   /INFO
  57.  
  58.     The /INFO option only works from the command line and displays a
  59.     description of PBTLIB and some registration information.
  60.  
  61.   /LIB
  62.  
  63.     The /LIB option works in interactive mode and from the command line,
  64.     and provides you a list of objects and units in the current library.
  65.  
  66.   /NOLOGO
  67.  
  68.     The /NOLOGO option only works from the command line and suppresses
  69.     the logo banner which displays the version of PBTLIB and copyright
  70.     information.
  71.  
  72.   +module
  73.  
  74.     The +module command works on the command line and in interactive
  75.     mode, and adds the specified module to the selected library.  If
  76.     you are in the interactive mode and type in a module name without
  77.     a command, the + is assumed.  Example:
  78.  
  79.       pbtlib MYLIB +MYFUNC.PBU +MYSUB.OBJ
  80.  
  81.   -module
  82.  
  83.     The -module command works on the command line and in interactive
  84.     mode, and removes the specified module from the selected library.
  85.     This does not extract the module to your hard disk, it only deletes
  86.     it from the library.  Example:
  87.  
  88.       pbtlib MYLIB -MYFUNC.PBU
  89.  
  90.   -+module
  91.  
  92.     The -+module command works on the command line and in interactive
  93.     mode, and updates the specified module in the selected library.
  94.     This is done by first deleting the module from the library, then
  95.     adding the new module from the specified path.  If the module does
  96.     not exist in the library, an error message will be displayed informing
  97.     you, but the new module will be added to the library and operation will
  98.     continue.  Example:
  99.  
  100.       pbtlib MYLIB -+MYSUB.OBJ
  101.  
  102.   *module
  103.  
  104.     The *module command works on the command line and in interactive
  105.     mode, and extracts the specified module from the selected library.
  106.     This copy's the module to a file from within the library.  If the
  107.     module already exists in the specified path, it will be overwritten.
  108.     The module is not removed from the library.  Example:
  109.  
  110.       pbtlib MYLIB *MYSUB.OBJ
  111.  
  112.   -*module
  113.  
  114.     The *module command works on the command line and in interactive
  115.     mode, and extracts the specified module from the selected library
  116.     and removes it from the library.  If the module already exists in
  117.     the specified path, it will be overwritten.  Example:
  118.  
  119.       pbtlib MYLIB -*MYSUB.OBJ
  120.  
  121.   ,listfile
  122.  
  123.     The ,listfile option tells PBTLIB to generate a map of all modules,
  124.     procedures names, and external declarations for the target library.
  125.  
  126.  
  127. MISC INFO:
  128.  
  129.   If you do not specify an extension, PBTLIB will first try the extension
  130.   .PBU to see if the file exists, then .OBJ.  If neither is found, an
  131.   error message is displayed.
  132.  
  133.   If command options are placed on the command line, PBTLIB will not
  134.   go into interactive mode, but instead will execute the commands on
  135.   the command line, then exit.
  136.  
  137.   You may place all of the commands into a text file and use the @
  138.   designator on the command line to have PBTLIB execute the commands
  139.   contained in the text file.  For example, if TEST.RSP contains the
  140.   following commands:
  141.  
  142.     +MYFUNC
  143.     +MYSUB
  144.     +PBTOOLS
  145.  
  146.   You can pass TEST.RSP to PBTLIB to create the library CUSTOM using
  147.   the following command:
  148.  
  149.     pbtlib CUSTOM @TEST.RSP
  150.  
  151.   It's important to note, that unlike MicroSoft's LIB and Borland's
  152.   TLIB, PBTLIB does not require the & charactor at the end of each line
  153.   to indicate another command follows on the next line.  PBTLIB
  154.   considers the entire text file to be nothing but commands.  You also
  155.   do not need to put just one command on each line.  You can put multiple
  156.   commands on each line, as long as each one is seperated by a space.
  157.   PBTLIB will skip any lines which are blank, and you can use the ;
  158.   charactor to indicate comments which will also be skipped.
  159.  
  160.  
  161. IT'S SHAREWARE:
  162.  
  163.   This program has been released as shareware.  Shareware is a method of
  164.   software distribution which allows users to try a program before they
  165.   are REQUIRED to pay for it.  PBTLIB can be tried for a 30 day period,
  166.   after which you must either stop using it, or pay a license fee to the
  167.   author for it's continued use.
  168.  
  169.   It's important to note that PBTLIB is not crippled in any way, nor does
  170.   it display any annoying "UNREGISTERED" messages.  It is up to you (and
  171.   your conscience) to pay the registration fee when the time comes.  For
  172.   more information on the cost of registration and licensing information,
  173.   see the accompanying LICENSE.DOC file.
  174.  
  175.  
  176. CONTACTING THE AUTHOR:
  177.  
  178.   The author can be reached either by U.S. mail or electronic mail for
  179.   problems, questions, or suggestions.
  180.  
  181.            Dave Navarro, Jr.
  182.            66-22 79th Place, Suite #2
  183.            Middle Village, NY  11379
  184.  
  185.            BBS:       (718) 837-3236
  186.            CIS:       73002,3506
  187.            Internet:  pbtools@consultant.com
  188.  
  189.